home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C++ / Applications / Lookup 1.0d2 / Grok Me < prev    next >
Encoding:
Text File  |  1995-10-22  |  3.5 KB  |  101 lines  |  [TEXT/CWIE]
  1. L o o k u p
  2. -----------
  3.  
  4. An example application for PowerPlant.
  5.  
  6. Version 1.0d2
  7.  
  8. Written by Alastair Rankine, Copyright © 1995.
  9.  
  10. mailto:alastair@magna.com.au
  11. http://www.magna.com.au/~alastair
  12.  
  13.  
  14.  
  15. What it does
  16. ------------
  17.  
  18. Lookup, as the name implies, is a name and phone number lookup application. You can store
  19. two phone numbers and an email address with each name listed in the file. The file format
  20. is tab-delimited text which means (hopefully) easy data conversion from other systems.
  21.  
  22.  
  23.  
  24. What it is
  25. ----------
  26.  
  27. Given the scarcity of PowerPlant example code, I thought I'd write a fully-functional
  28. application using the framework mainly for my own enlightenment, and hopefully others
  29. can benefit as well. This version is very much a development version and I hope to update
  30. it to be a bit more useful in future versions. In the meantime though, perhaps fellow
  31. PowerPlanters will find it informative.
  32.  
  33. The following techniques/features are illustrated :
  34.  
  35.  • Document-based application. This app is a bit more fleshed out than the demo provided
  36.    with PowerPlant.
  37.  
  38.  • Separation of model from view. PowerPlant contains an object dependency mechanism built
  39.    in to the core of the framework. I have employed this successfully to tie the document
  40.    object (containing the user's data) to the view objects (ie the windows, lists, etc)
  41.    without any tight coupling.
  42.  
  43.  • AppleEvent Object Model support. The AEOM classes are, IMHO, PowerPlant's strongest
  44.    point. As you can see, I have implemented a fully object model scriptable application
  45.    with a minimum of code.
  46.  
  47.  • Fully factored application. Examples are given on how to use the LAEAction class to
  48.    make the application fully factored. It is scriptable, recordable, and quite easy as
  49.    you can see.
  50.  
  51.  • Utility classes/templates such as as an LList wrapper, and an ANSI string class wrapper.
  52.  
  53.  
  54.  
  55. Building the Application
  56. ------------------------
  57.  
  58. To build the 68K version, simply open the "Lookup68K_d.µ" project file and make. The
  59. resulting application is used to build the fat version. To do this, open the
  60. "LookupFAT_d.µ" project file and make.
  61.  
  62.  
  63.  
  64. Soon to come
  65. ------------
  66.  
  67. There are lots of PowerPlant's features that I would like to make use of in future versions
  68. of this application. The main one, of course, is direct manipulation including Drag & Drop.
  69.  
  70. I'd also like to clean up the document handling somewhat. PowerPlant's document class is a
  71. little thin (at least compared with MacApp) and I'd like to attempt a smarter version.
  72.  
  73. Please feel free to email me at the above address if you have any questions or suggestions.
  74.  
  75.  
  76.  
  77. Version History
  78. ---------------
  79.  
  80. 1.0d1    First development release.
  81. 1.0d2    Updated for CodeWarrior IDE 1.3, PowerPlant 1.2.
  82.  
  83.  
  84.  
  85. Legal Stuff
  86. -----------
  87.  
  88. [I should note that for convenience I have included the bare-essentials of Harold Ekstrom's
  89. CListBox class. This is obviously not subject to my copyright or the following conditions.]
  90.  
  91. This program is free software; you can redistribute it and/or modify it under the terms of
  92. the GNU General Public License as published by the Free Software Foundation; either version
  93. 2 of the License, or (at your option) any later version.
  94.  
  95. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
  96. without even the implied warranty of  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  97. See the GNU General Public License for more details.
  98.  
  99. You should have received a copy of the GNU General Public License along with this program;
  100. if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  101.